Nathanael's Debug Tools

This is just a repository for ebugging code which I found I was copy-pasting between different work-in-progress games. This is released in case it might help someone else.

This eliminates the "Are you sure?" question when quitting; useful to speed up the command-line test/edit cycle.

Tracing startup rules is important when you need it, and requires a lot of code to set up (included here) but rather annoying most of the time. It's enabled with
Use startup rules tracing

Version 2/210331 of Nathanael's Debug Tools by Nathanael Nerode begins here.

"Miscellaneous stuff I like to have built in when debugging and programming, but would never want to relase."

Section - Quit Faster

[Speed up the debug cycle by not asking for confirmation before quitting.]

Include (-
[ QUIT_THE_GAME_R;
if (actor ~= player) rfalse;
if ((actor == player) && (untouchable_silence == false))
quit;
];
-) instead of "Quit The Game Rule" in "Glulx.i6t".

Section - Startup Debugging

Use startup rules tracing translates as (- CONSTANT STARTUP_RULES_TRACING; -).

[ See RulesOnSub in Tests.i6t for reference ]
To turn rules tracing on:
(- debug_rules = 1; -)

This is the trace rules at startup rule:
if the startup rules tracing option is active:
turn rules tracing on;

[ We want to let the game initialize memory, start the virtual machine, and seed the RNG before tracing starts.]
The trace rules at startup rule is listed after the seed random number generator rule in the startup rulebook.
The trace rules at startup rule is listed before the update chronological records rule in the startup rulebook.

[ The first rule which will actually trace is the "start in the correct scenes" rule. This is because NI doesn't instrument the earlier startup rules with the debug code, a problem we can't fix because NI is closed-source. ]
[ The untraceable rules in Standard Rules are:
initialize memory
virtual machine startup
seed random number generator
update chronological records
declare everything initially unmentioned -- the one we might want to trace
position player in model world
]

Nathanael's Debug Tools ends here.